home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / catD / strcat.z / strcat
Encoding:
Text File  |  2002-10-03  |  3.0 KB  |  66 lines
  1.  
  2.  
  3.  
  4. ssssttttrrrrccccaaaatttt((((DDDD3333))))                                                          ssssttttrrrrccccaaaatttt((((DDDD3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _ssss_tttt_rrrr_cccc_aaaa_tttt - concatenate strings
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_tttt_yyyy_pppp_eeee_ssss_...._hhhh_>>>>
  13.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_yyyy_ssss_////_dddd_dddd_iiii_...._hhhh_>>>>
  14.      _cccc_hhhh_aaaa_rrrr _****_ssss_tttt_rrrr_cccc_aaaa_tttt_((((_cccc_hhhh_aaaa_rrrr _****_s_p_t_r_1_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_s_p_t_r_2_))))
  15.  
  16.    AAAArrrrgggguuuummmmeeeennnnttttssss
  17.      The arguments _s_p_t_r_1 and _s_p_t_r_2 each point to strings, and each string is
  18.      an array of characters terminated by a null-character.
  19.  
  20. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  21.      The function _ssss_tttt_rrrr_cccc_aaaa_tttt appends a copy of the string pointed to by _s_p_t_r_2
  22.      including the terminating null-character to the end of the string pointed
  23.      to by _s_p_t_r_1.  The initial character in the string pointed to by _s_p_t_r_2
  24.      replaces the null-character at the end of the string pointed to by _s_p_t_r_1.
  25.  
  26.      The function _ssss_tttt_rrrr_cccc_aaaa_tttt alters _s_p_t_r_1 without checking for overflow of the
  27.      array pointed to by _s_p_t_r_1.  If copying takes place between strings that
  28.      overlap, the behavior is undefined.
  29.  
  30.    RRRReeeettttuuuurrrrnnnn VVVVaaaalllluuuueeeessss
  31.      The function _ssss_tttt_rrrr_cccc_aaaa_tttt returns the value of _s_p_t_r_1, which points to the
  32.      null-terminated result.
  33.  
  34. UUUUSSSSAAAAGGGGEEEE
  35.      Character movement is performed differently in different implementations;
  36.      thus, overlapping moves may yield surprises.
  37.  
  38.    LLLLeeeevvvveeeellll
  39.      Base or Interrupt.
  40.  
  41.    SSSSyyyynnnncccchhhhrrrroooonnnniiiizzzzaaaattttiiiioooonnnn CCCCoooonnnnssssttttrrrraaaaiiiinnnnttttssss
  42.      Does not sleep.
  43.  
  44.      Driver-defined basic locks, read/write locks, and sleep locks may be held
  45.      across calls to this function.
  46.  
  47. RRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
  48.      _bbbb_cccc_oooo_pppp_yyyy(D3)
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.